home *** CD-ROM | disk | FTP | other *** search
/ Aminet 3 / Aminet 3 - July 1994.iso / Aminet / util / misc / man31.lha / Man3.1 / DOCS / Deutsch / Man.DOK < prev    next >
Encoding:
Text File  |  1994-05-02  |  8.2 KB  |  248 lines
  1. DOCUMENT Man
  2.  
  3. Man v3.1 - © 1993,1994 by Markus Hillenbrand
  4. --------------------------------------------
  5.  
  6. Man ist ein Hilfsprogramm zum Anzeigen von Texten aus der Shell heraus.
  7. Dazu muß das Commodity aber schon geladen sein.
  8.  
  9.  
  10. 1. Systemvoraussetzungen
  11. ~~~~~~~~~~~~~~~~~~~~~~~~
  12.  
  13. Benötigt werden:  - asl.library         v37
  14.                   - intuition.library   v37
  15.                   - gadtools.library    v37
  16.                   - graphics.library    v37
  17.                   - dos.library         v37
  18.           - icon.library        v37 
  19.           - commodities.library v37 
  20.           - workbench.library   v37
  21.  
  22. Unterstützt wird: - locale.library      v38
  23.                   - reqtools.library    v38 (Busy-Pointer)
  24.                   
  25. Empfohlen wird :  - eine Festplatte zur effizienten Nutzung von Hilftexten
  26.                   - "Multiview" von OS3.0 zum automatischen Anzeigen von
  27.                     .guide-Dateien
  28.           - "AmigaGuide" von OS2.0 als Ersatz für Multiview, wenn
  29.              kein OS3.0 vorhanden
  30.  
  31. 2. Installer
  32. ~~~~~~~~~~~~
  33.  
  34. Da das Programm Installer (© by Commodore) nicht frei kopiert werden darf
  35. und für die Installation nötig ist, müssen Sie dafür sorgen, daß dieses
  36. Programm im Befehlspfad Ihrer Shell liegt (z.B. C:, SYS:Utilities, ...).
  37. Sie finden den Installer auf Ihrer Workbench-Diskette von OS2.0, OS2.1
  38. bzw OS3.0.
  39.  
  40. Falls Ihre Version des Installers nicht mit der Installationsdatei von Man
  41. funktionieren sollte, gehen Sie wie folgt vor:
  42.  
  43.    1. Klicken Sie das Icon 'Man' an und legen Sie es im Verzeichnis 
  44.       'Workbench:WBStartup' ab.
  45.    2. Falls Sie über OS2.1 verfügen, kopieren Sie das Verzeichnis
  46.       'Catalogs' nach 'Locale:catalogs'.
  47.  
  48.  
  49. 3. ToolTypes
  50. ~~~~~~~~~~~~
  51.  
  52. Das Programm sucht beim Start nach den folgenden Tooltypes:
  53.  
  54. 3.1. CX_PRIORITY
  55. ~~~~~~~~~~~~~~~~
  56.  
  57. CX_PRIORITY=x, wobei x für einen Wert mit -128<x<127 steht. Dieser Wert
  58. gibt die Priorität des Commodities an. Voreingestellt ist 0.
  59.  
  60. 3.2. CX_POPKEY
  61. ~~~~~~~~~~~~~~
  62.  
  63. Hier kann man den Hotkey angeben, bei dem das Konfigurationsfenster ge-
  64. öffnet werden soll. Voreingestellt ist 'ctrl lalt m'.
  65.  
  66. 3.3. DONOTWAIT
  67. ~~~~~~~~~~~~~~
  68.  
  69. Dieser Eintrag ist nicht weiter von Bedeutung; er ist nur für den System-
  70. start wichtig.
  71.  
  72. 3.4. HOTKEY
  73. ~~~~~~~~~~~
  74.  
  75. Hier kann man den Hotkey angeben, bei dem der Text-Requester angezeigt
  76. werden soll. Voreigestellt ist 'ctrl help'.
  77.  
  78. 3.5. DELAY 
  79. ~~~~~~~~~~
  80.  
  81. Der hier angegebene Wert sorgt für eine Verzögerung nach dem Start, bis
  82. die Liste aller Texte eingelesen wird. Dies ist besonders nützlich, wenn
  83. beim Systemstart viel auf der Festplatte gearbeitet wird. Der Wert wird
  84. in Sekunden angegeben. Also sorgt DELAY=10 für eine 10 sekündige Pause,
  85. bis alles gelesen wird. 
  86.  
  87. 3.6. DATA
  88. ~~~~~~~~~
  89.  
  90. Der hier angegebene Dateiname ist für die Liste der Texte. Unter diesem 
  91. Namen werden die Text-Namen und ihre Pfade gespeichert. Voreingestellt
  92. ist 'Work:Man.LST'.
  93.  
  94.  
  95. 4. Konfiguration
  96. ~~~~~~~~~~~~~~~~
  97.  
  98. Das Programm wird konfiguriert, indem man in der Shell "man -c" oder
  99. "man -config" eingibt. Danach erscheint ein Window, in dem verschiedene
  100. Einstellungen gemacht werden können.
  101.  
  102. Das Konfigurationsfenster wird aber auch geöffnet, indem man das Icon
  103. des Programmes zweimal anklickt oder aber (wenn das Commodity schon in-
  104. stalliert ist) bei Exchange (© by Comodore) das Gadget 'Fenster öffnen'
  105. anklickt.
  106.  
  107. Das geöffnete Fenster ist ein App-Window, d.h. daß Icons, die auf dieses
  108. Fenster gezogen werden, automatisch in die Liste im Listview-Gadget über-
  109. nommen werden.
  110.  
  111. Das Fenster ist in vier Sektionen unterteilt:
  112.  
  113. 4.1. Liste der Hilfs-Texte
  114. ~~~~~~~~~~~~~~~~~~~~~~~~~~
  115.  
  116. In der oberen Hälfte des Fensters ist ein Listviewgadget, in dem alle zur
  117. Zeit aktuellen Texte angezeigt sind. Rechts daneben befinden sich einige 
  118. Gadgets, die folgendes bewirken:
  119.  
  120. 4.1.1. Zufügen|Add
  121. ~~~~~~~~~~~~~~~~~~
  122.  
  123. Klickt man dieses Gadgets an, so wird ein Requester geöffnet, mit dem man
  124. einen einzelnen Text hinzufügen kann.
  125.  
  126. 4.1.2. Löschen|Delete
  127. ~~~~~~~~~~~~~~~~~~~~~
  128.  
  129. Der im Listview-Gadget hervorgehobene Text wird (ohne Sicherheitsabfrage)
  130. aus der Liste gelöscht.
  131.  
  132. 4.1.3. Ändern|Edit
  133. ~~~~~~~~~~~~~~~~~~
  134.  
  135. Der im Listview-Gadget hervorgehobene Text kann mit diesem Gadget geändert
  136. werden (falls sich z.B. der Pfad geändert hat).
  137.  
  138. 4.1.4. Einlesen|ScanDir
  139. ~~~~~~~~~~~~~~~~~~~~~~~
  140.  
  141. Mit diesem Gadget kann ein ganzes Verzeichnis rekursiv durchsucht werden.
  142. Alle gefundenen Texte werden in das Listview-Gadget übernommen. Dieses
  143. Gadget ist bei der ersten Benutzung von Man besonders angebracht, da es
  144. viel Arbeit spart, z.B. den gesamten Pfad DH1: zu durchsuchen.
  145.  
  146. 4.1.5. LöschAll|DelAll
  147. ~~~~~~~~~~~~~~~~~~~~~~
  148.  
  149. Das soll heißen: Alles Löschen. Dieses Gadget bewirkt ein Löschen der ge-
  150. samten Liste. Aber keine Angst, es gibt eine Sicherheitsabfrage.
  151.  
  152.  
  153. 4.2. Anzeigeprogramm
  154. ~~~~~~~~~~~~~~~~~~~~
  155.  
  156. Im Gadget "Anzeigeprogramm" kann man einen Textanzeiger angeben, mit dem
  157. die Hilftexte angezeigt werden sollen. Das Gadget rechts neben dem String
  158. Gadget öffnet einen Requester, mit dem das Programm ausgewählt werden 
  159. kann.
  160.  
  161. 4.3. Standard-Gadgets
  162. ~~~~~~~~~~~~~~~~~~~~~
  163.  
  164. Mit 'Speichern' wird die aktuelle Konfiguration in gespeichert. Mit 'Verber-
  165. gen' wird das Fenster geschlossen und mit 'Beenden' wird das Commodity aus
  166. dem Speicher entfernt (eventuelle Änderungen werden NICHT gespeichert!!!)
  167.  
  168.  
  169. 5. Benutzung von der Shell aus
  170. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  171.  
  172. Um von der Shell aus einen Text anzeigen zu lassen, muß man diesen angeben.
  173. Dabei ist die Endung wegzulassen. "Man lha" sucht demnach in der Liste der
  174. Texte nach lha.doc, lha.dok, lha.man oder lha.guide oder ...
  175. Der Text wird dann mit dem voreingestellten Textanzeiger angezeigt.
  176. Gibt man "man -l" an, so wird eine Liste der Texte ausgegeben. Ruft man das
  177. Programm ohne Parameter auf, so wird eine Liste aller verfügbaren Hilfstexte
  178. angezeigt, in der man einen Text auswählen kann.
  179. Gibt man einen Pattern an (#?, ? usw.), so werden alle Texte, die zu diesem
  180. Pattern passen, aufgelistet. Paßt nur ein Text, so wird dieser gleich ange-
  181. zeigt.
  182. Mit "man -q" wird von der Shell aus das Kommodity verlassen.
  183.  
  184. 6. Lokalisierung unter WB2.1+
  185. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  186.  
  187. Ab der Workbench 2.1 kann das Programm lokalisiert werden, das heißt es
  188. kann leicht in andere Sprachen übersetzt werden. Dazu ist der C-Quelltext
  189. von MAN.catalog dem Programm beigefügt. Im Original werden nur deutsch,
  190. schwedisch und englisch unterstützt.
  191. Der C-Text kann jedoch erweitert werden und mit einem geeigneten Programm
  192. (z.B. MakeCAT - © by Paladin-Software) wieder in einen Katalog umgewandelt
  193. werden.
  194. Wenn Sie den Katalog in eine andere Sprache übersetzen, so wäre es sehr nett,
  195. wenn Sie mir den Quelltext dieses neuen Katalogs per e-mail zusenden würden,
  196. damit die Sprache in neueren Versionen von Man schon von vornherein unter-
  197. stützt wird!
  198.  
  199.  
  200. 7. Copyright und Anderes 
  201. ~~~~~~~~~~~~~~~~~~~~~~~~
  202.  
  203.    Copyright (C) 1993 by Markus Hillenbrand
  204.  
  205. Dieses Programm darf kopiert und weitergegeben werden solange die Copyright-
  206. Notiz und diese Dokumentation unverändert auf allen Kopien enthalten ist.
  207.  
  208. Es wird keine Garantie gegeben, daß das Programm 100%ig zuverlässig ist. 
  209. Sie benutzen dieses Programm auf eigene Gefahr. Der Autor kann auf *keinen*
  210. Fall für irgendwelche Schäden verantwortlich gemacht werden, die durch die 
  211. Anwendung dieses Programmes entstehen.
  212.  
  213. Das Paket ist "freely distributable", aber das Copyright liegt weiterhin 
  214. bei Markus Hillenbrand. Dies bedeutet, daß es von jedem kopiert werden darf,
  215. solange er nicht mehr als eine angemessene Kopiergebühr dafür verlangt. 
  216.  
  217. Dieses Paket darf in Public-Domain Sammlungen aufgenommen werden, in
  218. Mailboxsystemen oder auf FTP Servern abgelegt werden. Wenn Sie dieses
  219. Paket weitergeben wollen, dann *müssen* Sie die originale
  220. Distributionsdatei "man30.lha" benutzen.
  221.  
  222. Dieses Programm darf nicht ohne eine schriftliche Genehmigung des Autors in 
  223. kommerziellen Programmen benutzt werden.
  224.  
  225.  
  226. 8. Adresse des Autors
  227. ~~~~~~~~~~~~~~~~~~~~~
  228.  
  229. Hier ist meine Adresse (für Anregungen, Bug-Report, oder Sonstiges):
  230.  
  231.                Markus Hillenbrand
  232.                Weserstraße 9
  233.                36124 Eichenzell-Löschenrod
  234.  
  235.                GERMANY
  236.  
  237.  
  238. oder e-mail:   m_hillen@informatik.uni-kl.de
  239.  
  240.  
  241. 9. Man-Pages
  242. ~~~~~~~~~~~~
  243.  
  244. Wenn Sie Interesse daran haben, eine Hilfs-Datei zu schreiben, so beachten
  245. Sie bitte die Hinweise in Verzeichnis "ManPages".
  246. Außerdem können Sie Lars Oloffson (e-mail: pt93lo@pt.hk-r.se) kontaktieren,
  247. um ein Archiv von Hilfs-Texten für die original AmigaDOS Befehle zu bekommen.
  248.